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i»0 Introduction and Overview 



This document is intended to describe the various record formats 
that the LCG tape utilities? Backup Bt~i<i Dumper? produce. For people 
interesting in learning about Backup's record formats? you will 
probably find enough information in the section on Backup* For those 
seeking to learn about Dumper? you had best read everything * In order- 
to understand how Dumper fails to faithfully follow the Interchange 
format? you should understand how it is supposed to be done by reading 
about Backup* 

***WARNING**# 



This document is not intended for the beginner* This 
document is a reference guide to the record formats* It is 
suggested that you carefully read the entire document before 
attempting to use the information. Each section contains in- 
formation that you will need to know before being 3ble to 
understand the next section* Each section builds up on the 
information presented previously* Therefore if you decided 
to start in the middle and encounter a problem? you probably 
could have avoided it by reading everything first* 



1*1 Sources of Information 



Backup and Dumper appear to come from two separate realities* 
Historically Dumper was written before Backup? but the Interchange 
mode that they both share is based on the way that Backup does things. 



The reader is expected to be able to find out some information on 
his own* For example? when the various parts of TQPS-IG file RIB or a 
TOPS-20 FDB are being discussed? it is expected that you can use your 
Notebook sets to find the appropriate data. (This information can be 
found in the respective Monitor Calls Reference Guide for your sys- 
tem*) This document will not take the time to explain information 
readily available in the notebooks except to point out where you can 
find it. 

For TOPS-20 people? recommended reading is the Tape Processing 
Manual which currently lives in Notebook 16* This will give you a 
basic understanding of how tapes are supposed to work? how the infor- 
mation is put onto the tape? the differences between labeled and 
unlabeled tapes? and the format of the tapes in terms of tape files? 
tape marks? and other system considerations* For those of you who 
don't have TOPS-20 notebook sets the order number is AA-H1S0A-TM » 

For TOPS-10 people about all you will find is the Backup guide 
stuck in Appendix F of the Operators Guide? which is in Notebook 15. 
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Another place to find information is the source code to Backup. Run 
the source files through RUNOFF and you will get . PLM files . These 
Program Logic Manuals are somewhat informative? but they are aimed at 
the engineer/maintainer who works regulsry with the internal code. 

Basically* the reader should have available the Monitor Calls 
Reference Guide for their particualar system? the users guide for 
their favorite magtspe utility? and a copy of the source code. The 
reader of this document is expected to be an experienced MACRO pro- 
grammer and be familiar with the internal workings of their operating 
system (TQPS-10 or TQPS-20). This document can also be used as a de~ 
buging aid to figure out if /how your tape possibly got corrupted? but 
where to set break points 3nd how to examine the inconiming/outgoing 
buffers is left to the reader. (Hint? the Backup .PLM manual tells you 
where the input/output routines are and Dumper uses the DUMPO/DUMPI 
Jsys to put the dats to t3pe * ) 
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2»0 Definitions and Conventions 



This section will attempt to set some conventions and explain 
some definitions that occur in this document. This is ***NOT*** a pri- 
mer on how magtapes work. 



Record 

A record is one buffer of information written/read to tape 
A record is made up of a header section and a data area. 



Header 

A header is at the top of a record. A header contains 
information about the contents of the record such as the 
checksum and the seauenee number of the record. The header 
information is an unioue identifier for each record on the 
tape. 



Data Area 



The dat3 area of a record is where the contents of a disk 
file or other types of file information are stored. The data 
areas for both Backup and Dumper are one page in length. 
This size conviently holds 1 P3ge of disk data. Room is not 
reserved in the header area for variable length inf ormation 
about a file such 3S the filename? the user name? or the 
path of the directory. This kind of information can be found 
in the data ares. With only one exception? you will not find 
disk dats and variable information in the data area at the 
same time. 



Record Type 



There are different types of 
tain disk file data. There 
start and the end of a disk 
indicate the start and the 



Each record type is given 
tinsuish it from the rest- 



records. Not all records con- 
are records that indicate the 
file? there are records which 
end of a saveset (tape file). 



3 different numeric value to dis- 



Seouence Number: 



A seauenee number is given to each record on 3 tape. The 
first record is given a sesuence number of one? the second a 
seouence number of two? and so on. If a record is duplicated 
on tape due to an error on write? a seouence number will be 
repeated to indicste that both records are supposed to eon- 
tain identical information. Therefore if there is an error 
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in reading the record back and then the next record contains 
the same seeuence number? then that record has a second 
chance at being restored successfully* 

Relative Tape Numbers 

Relative tape numbers are issued in the same manner as rec- 
ord seauenee numbers. All of the files saved on the first 
tape of tape volume will have a relative tape number of one* 
files saved onto the next continuation tape will have a re- 
lative tape number of two? ami so on> 



Tape Label 

A tape label is a record which identifies the tape. It is 
the first record written to tape and can contain such infor- 
mation as density? parity? system information and reel-id of 
the tape.. System software will read this information and set 
parameters with it. 



3.0 Labeled end Unlabeled Tapes 



TOPS-20 is the only LCG system that writes labeled tapes at this 
point in history. Labeled tapes for T0PS-10 is comming at some point 
in the future. Labeled tapes contain "extra" records which identify 
the start of a volume? start of a saveset? end of a saveset? etc. 
These records will not be discussed here because they are supposed to 
be transparent to the user and they are already described in the Tape 
Processing Manual. The only warning that should be heeded about 
labeled tapes is that they only work when the software to read those 
labels is running <IE. MOUNTR? GALAXY). You cannot expect to use la- 
beled tapes for INTERCHANGE mode between 10 and 20. Dumper will not 
handle labeled tapes without GALAXY/MOUNTR running as well. 

Then there are unlabeled tapes. Currently? all the tapes that 
T0PS-10 produces are unlabeled. Unlabeled tapes contain only the rec- 
ords that are dicussed in this document. 
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All records have a standard length of 544 < 10) words* The first 
32(10) words are the header and the remaining 512(10) words are the 
data srest All undefinded or unused words are written with zeros and 
ignored on read* This maximizes the probability of reading old tapes* 



4*1 Record Types 



Must be at start of tape* 



Name 


Va 


1 


ue 


Contents 


TfLBL 


1 






Tape Label - M 


T*BEG 


**> 






Saveset Header 
- includes 
o Saveset name 
o Device 
o System 



- Must be first record of saveset 

T*END 3 - Saveset Trailer 

- identical to TfBEG in format 

T*FIL 4 - data record 

T$UFD 5 - contains directory information 

- is used to rebuild directory 

- not written in Interchange mode 

- end of volume 

- comment record (ignored) 

- continuation of saveset 

- S3me as T$BEG in format 



T*E0V 


6 


T*C0M 


7 


T*C0N 


10 
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4.2 Standard Record Format 



The first 12 words of the header are identical for every record. 
Words zero through 6 3nd 13 are already defined* Words 7 through 12 
are empty for future use. In Interchansie mode? the customer word will 
he set to zero on write and ignored on read. 

Word Name Contents 

Word (6$TYPE) Contains record type value. 

Word 1 <G*SEQ) Sequence number of record. 

This is incremented by one for each record on the 
tape. If a record is repeated because of a tape 
write error? the number of the repeated record is 
the same as that of the original. 

Word 2 (GfRTNM) Relative tape number. 

Word 3 <G*FLAG) Uarious flags about the record. 

GF$EOF <1B0) Last record of disk file. 

GF$RPT (1B1) Repeat of last record, 

GFfNCH (1B2) Ignore checksum. 

GFfcSOF C1B3) Start of file, 

GFt>UF£ Disk error. 

Word 4 (G$CHK) Checksum of record. 

Word 5 <G$SIZ) Number of words used as d3ta. 

Word 6 (G$LND) Number of words to skip before data starts. 

Word 13 <G$CUSW) Customer word. 
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4*3 Non-data Information Blocks 



Non-dat3 information blocks start with a control word containing 
the numeric type of the information block in the left half? and the 
length of the block (including the control word) in the right half <• 
More than one tape of non-data information block may appear per rec- 
ord* These non-data blocks will appear in the data section of the 
record* They do not contain the contents of the file? they are merely 
pieces of information about the disk file being written on tape* 



Value 



Name 



Contents 



1 
n 

a— 

3 
4 



0$NAME Path identification of file 

0$FILE File information 

0$DIRT Directory information 

0$SYSN System header 

G$SSNM Saveset name 



4*3*1 Q$NAME 



block 

- full path identification of file without punctuation 

- uses sublocks to store information 

o device 

o directories (top-down order) 

o file 

o extension 

o version 

o generation 

- each sub-block headed by a control word of* 

Ltype? ? length] 

- information is ASCII string terminated by a null 

- omitted fields are defaulted 

- in Interchange only name? ext» and version sv& 
written 
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4»3»2 0$F1'LE (File Information) 




Name 



Value 



Contents 



<*) 



A*FHLN 
A*FLGS 



Fixed header length in words 

1 flags 



B*PERM (1B0) Pern3ment CRP*NDLD 

B$TEMP (1B1) Temporary 

B$DELE (1B2) Already deleted 

B$DLRA (1B3) Don't delete CRP.ABU3 

B*NQCF (1B4) Not euota checked CRP«NQC3 

B«NOCS (IBS) No valid checksums CRP, ASCII 

B$CSER (1B6) Checksum error ERP.FCED 

BtURER (1B7) Disk has write error CRP.FUE3 

B$MRER (IBS) Backup read error on restore CRP»BFA! 

B$DA£R (1B9) Bad by damage assesment CRP.BDA3 



*) 
#) 
*) 
*) 
*) 
*) 



A* WRIT 

A$ALLS 

A$MODE 

A$SIZ 

A*BSIZ 

AfcVERS 

A$PROT 

AfACCT 

A*NQTE 

A*CRET 

A$REDT 

A$MODT 

A$ESTS 

A$RABR 

AfFSIZ 

A$MUSR 

AfCUSR 

A$BKID 

A$BKDT 

A*NGRT 

A$NRDS 

A$NWRT 

A*USRW 

AtPCAW 



3 

4 

5 

6 

7 

10 

11 

12 
13 
14 
15 
16 
17 
20 
1 

23 
24 
25 
26 
?7 

30 

31 



Date/T 
Alloca 
Mode o 
Length 
Byte s 
Uersio 
Protec 
Byte p 

Byte p 
Creati 
Last r 
Monito 
Est i ma 
Reoues 
Max fi 
Byte p 
Byte p 
Byte p 
Dste/T 
Number 
Number 
Number 
Undef i 
Pri ved 



ime o 
ted s 
f las 
(byt 
ize ( 
n ( . J 
tion 
ointe 

ointe 
on da 
ead ( 
r set 
ted s 
ted d 
le si 
ointe 
ointe 
o i n t e 
ime o 

of 

of 

of 
ned 



Cust 



f last write CRB.CRD* RB-CRTII 

ize in words E*RBALCII 

t write CRB.MODII 

es) CRBSIZI! 

7 or 36) 

BVER format) C»RBVER3 

CRB.PRV.1 

r to account string 

r to annotation string C.RPSPLD 
te and time of this generation 
date/time) CRB*ACDII 

last write C.RMTIMII 
ize (words) C»RBEST11 
isk address C.RBPOS] 
ze (words) 
r to l3st modifier 
r to last creator C»RBAUT3 
r to BACKUP- id C.RBMTA3 
f last Backup 
enerations to retain 
pens for read this generation 
pens for write this generation 
ser word E»RBNCAII 
omer word C»RBPCAD 
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The following is a constant value rather than word with contents. 

LN*AFH 32 Length of fixed header 

4.3.2.1 Protection codes (A$PR0T) •••• 

The protection for directories appears in the directory attribute 
block <0*DIRT)» For files? the protection word has four fields of 
eight bits with 3 "5" in the leftmost three bits to prevent from 
looking like a byte pointer. 



Bits 0-2 
Bit 3 
Bits 4-11 
Bits 12-19 
Bits 20-27 
Bits 28-35 



Reserved for future expansion 
Future access 
Owner access 
Affinity group access 
"World" access- 



Each access field is sub-divided into bytes which represent the 
attribute? write and read protections associated with the file. 



Name 

PR$SPC 
PR$ATR 



Value 

(Bit 28) 
(Bits 29-31) 



Contents 

Reserved for special checking 
Attribute sub-field of 3-bit bytes 




1 
r > 

3 

4-5 
6 
7 



File completely hidden 

File name is visible (7-6) 

File attributes are visible (5-2) 

Can change unprotected attributes 

Reserved for future expansion 

Can change protection 

Can delete the file (1) 



PR$WRT 



(Bits 32-33) 



Write access sub-fields 





1 

3 



No write access (7-5) 

Append (4) 

Write (3) 

Superseding generation (2-0) 



PR*RED 



(Bits 34-35) 



Read access sub-fields 





1 

2 

3 



No read access (7) 

Execute only (6) 

Can r&Bdi the file (5-0) 

Reserved for future expansion 
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4*3*3 0$DIRT (Directory Attribute Information) 

The Q$DIRT block contains directory attributes (not written in 
Interchange mode)* The first section of this block is a fixed length 
header srea containing either directory attributes or pointers to 
attributes located in the remaining section* The symbols in brackets 
represent the RIB data used for conversion (the location is zero if 
none is given)* The directory protection word appears in this block 
rather than in the 0$FILE block (A$PROT is zero for directories)* 

Name Value Contents 

DfFHLN Fixed header length in words* 
D*FLGS 1 Directory flags* 

DF*FOD (1B0) Files only directory 
DF$AAL (IB!) Alpha accounts are legal 
DF$RLM (1B2) Repeat login messages 

D$ACCT 2 Account number or ASCII byte ptr to account 

string t. 

D$PR0T 3 Directory protection CRP*PRV3* 

DtFPRT 4 Default file protection* 

D*LOGT 5 Date/time of last login CRB*CRD and RB*CRT3* 

DfGENR 6 Default number of generations to keep* 

D$QTF 7 First-come-first-served logged-in Quota (words) 

C*RBQTF1. 

D$QTO 10 Logged out ouota in words E*RB(3T0I!* 

D$ACSL 11 List of groups that can access this directory* 

D$ISRL 12 List of groups that the user is in* 

D$PRVL 13 Privilege list* 

D$PSWD 14 ASCII byte pointer to password* 

4*3*4 OfSYSN (System Header Information) 



This block contains system header line in an ASCIZ string* 

4*3*5 0$SSNM (Saveset Name) 

This block contains the user supplied saveset name in ASCIZ (max 
of 30 characters) » This block is omitted if no saveset name was speci- 
fied * 
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4»4 Backup Record Formats 



4,4,1 T$LBL Record 



The T*LBL record contains only header information. There is noth- 
ing stored in the data area. 

Word Name Contents 

Word (G$TYPE) Record Type 

Word 1 (G$SEQ) Seauence number of record 

Word 2 (G$RTNM) Relative tape number 

Word 3 (GfFLAG) Flags 

Word 4 (G$CHK) Checksum of record 

Word 5 (G$SIZ) Number of words used as data 

Word 6 (G$LND) Number of words to skip before data starts 

Word 13 (G$CUSW) Customer word 

Word 14 (L$DATE) Date/Time (Universal format) 

Word 15 (L$FMT) Tape format version (1) 

Word 16 (L$BVER) Version number <.JBVER> of Backup 

Word 17 (L$MQN) XCNMNT monitor type 

Word 20 (L$SVER) XCNDVN system version 

Word 21 <L$APR) Processor serial number (integer) 

Word 22 (L*DEV) SIXBIT device written by 

Word 23 (L*HTCH) Tracks? density 

Word 24 (L$RLNM) SIXBIT reel-id 

Word 25 (L*DSTR) Date/Time before tape cannot be scratched 

Word 37 (UKCUSW) Customer Word 
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4,4.2 T*BEG» T$END* T*CON Records 

These records all contain the same information. They also contain 
Q$SYSN and 0$SSNM blocks in their data areas, They arm distinguished 
by their record types and their occurence on tape. 

Word Name Contents 

Word <G$TYPE> Record Type 

Word 1 <G$SEQ) Sequence number of record 

Word 2 (G$RTNM) Relative tape number 

Word 3 (6$FLAG> Flasis 

Word 4 (GfCHK) Checksum of record 

Word 5 (G$SIZ) Number of words used as data 

Word 6 <G$LND) Number of words to skip before data starts 

Word 13 <G$CUSW> Customer word 

Word 14 (S*DATE) Universal Date and Time 

Word 15 (SfFHT) Format version (BKFHT) 

Word 16 <S$BVER) Backup version (,JBUER> 

Word 17 (S$MON) %CNMNT monitor type 

Word 20 <S$Sv"ER> 3KCNDVN system version 

Word 21 (S$APR) Processor serial number (integer) 

Word 22 (S$DEv"> SIXBIT device written by 

Word 23 (Sf'MTCH) Tracks? density 

Word 24 (S*RLNM) SIXBIT reel-id 

Word 25 <S$LBLT) Octal label type 

Word 37 (S$CUSW) Customer Word 
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4.4,3 T$UFD Record 

This record contains the information needed to re-create a . UFD. 
This record is not written in Interchange format* When written? the 
data portion contains two or three non-data blocks! types 0$NAME? 
G*FILE (optional) and OtDIRT in the data section. 

Word Name Contents 

Word (G$TYPE) Record Type 

Word 1 (GfSEQ) Seeuence number of record 

Word 2 (G$RTNM) Relative tape number 

Word 3 (G$FLAG) Fla^s (none) 

Word 4 (GfCHK) Checksum of record 

Word 5 (G$SIZ) Number of words used as data 

Word 6 (G*LND) Number of words to skip before data starts 

Word 13 (G$CUSW> Customer word 

Word 14 (D*PCHK) Path Checksum 

Word 15 (D$LUL) UFD level (0=UFDy 1= first SFD» etc) 

Word 16 (DSSTR) File structure name 

Word 37 (D*CUSW) Customer word 
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4.4»4 T*FIL Record 



This record contains file data* On the first records' an OfNAME 

and an 0*FILE information block is written. File dat3 is put in the 

first record only if all of the file contents will fit in the block? 
otherwise file data starts with the next (second) record* 



Word 



Name 



Content! 



Word (G*TYPE) Record Type 

Word 1 <G*8EQ) Seeuence number of record 

Word 2 <G*RTNM> Relative tape number 

Word 3 <G$FL.A6) Flags 

Word 4 <G$CHK> Checksum of record 

Word 5 <G$SIZ) Used only in first data record 

Word 6 <G$LND) Used only in first data record 

Word 13 <G$CUSW) Customer word 

Word 14 <F*PCHK> Path checksum of file 

Word 15 (F$RDW> Relative dat3 word 

Word 16 (F$PTH) 12 word block for path info 

Word 37 <F$CUSW) Customer word 
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5*0 Dumper Tspe Formats 



Dumper has two distinctly different record formats* One is the 
mode that Dumper ordinarily uses by default* and the second is used 
for INTERCHANGE mode. 

Although Dumper uses only two different types of record formats? 
it will use different types of hardware data modes within those rec- 
ords. The INDUSTRY compatible switch will change the hardware mode 
from the standard unbuffered dump mode to industry compatible mode as 
defined in the TOPS-20 Monitor Calls Reference Guide. 

5.1 Standard Dumper Format 



Each physical record of the tape is 518(10) words long. The first 
6 words contain the checksum? access? tape number? page number? type 
of record? and sequence number of the record. The remaining 512(10) 
words of the record contains either 1 psse of disk dat3 or information 
related to the type of record being written. 

The following block description is pulled out of the source code 
of Dumper* 



FORMAT 



F 



DUMPER 



TAPE 



Each physical record written by Dumper contains one or more 
logical records? each of which 518 (1006 octal) words long. 

Each logical record has the following format? 



CHKSUM 







HwwUDD 


1 




TAPN0 


a 


SCD! 


PAGN0 


3 


Fl !F2! 


TYP 


«* 




SEQ 


b 





CHECKSUM OF ENTIRE 518-WORD RECORD 
PAGE ACCESS BITS (CURRENTLY NOT USED) 
SAVESE7KWJMBER ii! TAF'g^UMBER 

PAGE tff^N FILE 
RECORD TYPE CODE (NEGATED) 
RECORD SEQUENCE NUMBER (INCREASES BY 1) 



...___._ v . ._„r?: 

FILE ^§k*N SET ' 



...if. 



CONTENTS OF FILE PAGE IF DATA RECORD 
OTHER TYPES HAVE OTHER INFORMATION HERE 



TYPE 



VALUE 



MEANING 
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DATA 





TPHD 


1 


FLHD 


2 


FLTR 


3 


TPTR 


4 


USR 


5 


CTPH 


6 


FILL 


7 



Contents of file PsSe 

Non-continued saveset header 

File header (contains filespec? 

File trailer 

Tape trailer (occurs only after 

User directory information 

Continued ssveset header 

No meaning? used for padding 



FDD) 
last 



saveset ) 



SCD (3 bits) 



0=Normal save 
l=Col lection 
2=Arehive 
3=Mi g rat ion 



Fi 



F2 



Meaning 




1 

1 

L 




1 
1 




Old-format tape (no file # 

Old-format t3pe? continued 

New-format t3pe (file # in 

New-format tape? continued 






in PAGNO 
file 

PAGNO hits 
file 



bits 2-17) 
2-17) 
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A Dumper tape is a collection of records organised in the following 
fashion i 



HEADER FOR FIRST SAVESET (TPHD) 

USER INFO (USR) OR FILE (SEE BELOW) 

USER INFO OR FILE 



HEADER FOR SECOND SAVESET (TPHD) 
USER INFO (USR) OR FILE (SEE BELOW) 
USER INFO OR FILE 



SUBSEQUENT SAVESETS 



LAST SAVESET 



TAPE TRAILER (TPTR) 



Notes! 



3, 
4* 



On labeled tapes? the TPTR record appears only if the ssveset is 

continued on another tape* 

Solitary tape marks (EOF's) are ignored on input* 

Two consecutive tape marks are interpreted 3s TPTR. 

On labeled tapes? each ssveset occupies exactly one file* 

The first record of a continued saveset is CTPH instead of TPHD. 
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A disk file saved on 3 Dumper tape always has this sequence of rec- 
ords! 



FILE HEADER (FLHD) 
DATA RECORD J 1 PAGE OF FILE (DATA) 
DATA RECORD? 1 PAGE OF FILE (DATA) 



FILE TRAILER (FLTR) 



5»1*1 Types of Physical Records 



There are eight types of records that Dumper can write to tape 
TYP Name Contents 



1 page of disk data 

Saveset Header 

File Header 

File Trailer 

Tape Trailer (after last saveset) 

User-Di rectory Information 

Continuation Header 

Padding 






DATA 


1 


TPHD 


2 


FLHD 


3 


FLTR 


4 


TPTR 


5 


USR 


6 


CTPH 


7 


FILL 
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5»1»2 Data Record (record type 0) 



A DATA record contains the following information. 



Word 



Location Contents 



Word 
Word 
Word 
Word 
Word 
Word 



CHKSUM 

ACCESS 

TAPNO 

PAGNO 

TYP 

SEQ 



Word 6-1005 



Checksum of record 

<not used) 

Relative T3Pe Number 

Pa^e Number in File 

Record Type Code (negated) 

Record Seauence Number 

One paae of disk file data 



ton 
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5*1*3 Saveset Header (record type 1) 



The Saveset Header contains the name of the saveset as given with 
the SSNAME command? the current tape format number and the date and 
time. The current record format for Dumper is 4 as defined by CURFMT* 
The date and time sre in the universal date and time format* This 
record is the first record of every saveset* 



Word 



Location Contents 



Word CHKSUM 

Word 1 ACCESS. 

Word 2 TAPNQv 

Word 3 PABNO ■* 

Word 4 TYP S 

_Word 5 SEQ i/ 

Word *r :? BFMSGt/ 

Word ^ ie BGNTAD^ 



Word 



Checksum of record 
(not used) - 

Relative Tape Number 
Page Number in File 
Record Type Code (negated) 



C-13 



Record 

3 

Universal 



Seauence Number_ 
date and time 



11 SSNEUFi/ Saveset name* ASCIZ string — 



& 



y Ret/ 



oJl porrm 






3 ~ 'pZbhj-*-' 



«LNrf^^ 
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5*1 .4 File Header (record type 2) 



The file header 
well as the contents 
record of every file. 



record contains the ASCII name of 
of that file's FOB. This record 



the file as 
is the first 



Word 



Location Contents 



Word 
Word 
Word 
Word 
Word 
Word 
Word 

Word 



20^ 



CHKSUH Checksum of record 

ACCESS (not used) 

TAPNO Relative Tape Number 

PAGNO P3ge Number in File 

TYP Record Type Code (negated) C-23 

SEQ Record Sequence Number 

ASCII file name of the form? 

st rS<dir>f ile.ext . sen JP< protection) ? A (account) 

FDB 30y words of files FDB starting at word 
10$ words? ASCII author string 
10f words? ASCII last writer string 
6ywords containing archive information 






The FDB is broken up when stored. Only the first 30 words are 
stored in their original contiguous form. The words for the author and 
last writer strings contain offsets to the 10 word blocks where the 
ASCIZ strings are actually stored. Finally the last 6 words of the 
FDBj which contains archive information? is stored in the same order 
as in the FDB. This became split because archiving and extending FDBs 
were added in version 4 of TOPS-20. You will find the FDB stored in 
this "broken-up" fashion in other Dumper tape records as well. 
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5*1*5 File Trailer (record type 3) 

The File Trailer record contains the FDD of the file* This record 
is the l3st record written for every file* 

Word Location Contents 

Word CHKSUli Checksum of record 

Word 1 ACCESS (not used) 

Word 2 TAPNO Relative Tape Number 

Word 3 PAGNO Page Number in File 

Word 4 TYP Record Type Code (negated) L'-3D 

Word 5 SEC? Record Sequence Number- 
Word 6 FDD 30 words of files FDD starting at word 

10 words? ASCII author string 
10 words? ASCII last writer string 
6 words containing archive information 
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5.1.6 Tape Trailer (record type 4) 

This record is the same in format as the File Trailer record. 
This record is written only at the end of the last saveset written to 
tape. There is no saveset trailer record for every saveset as there is 
in Backup on TOPS-10, 

Word Location Contents 

CHKSUM Checksum of record 

ACCESS (not used) 

TAPNO Relative Tspe Number 

PAGNO Page Number in File 

TYP Record Type Code (negated) L-Al 

SEQ Record Seauence Number 

FDB 30 words of files FDD starting at word 
10 words? ASCII author strinss 
10 words? ASCII last writer strinsi 
6 words containing archive information 



Word 





Word 


1 


Word 


2 


Word 


3 


Word 


4 


Word 


5 


Word 


6 
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5*1*7 User-directory Information (record type 5) 



This record contains all the needed information to rebuild a 
user's directory. This information is set up to be taken as the argu- 
ment block to the CRDIR Jsys. See the CRDIR Jsys for a more detailed 
explanation of the values contained in the argument block* 

This record appears on the t3pe before the first file saved in 
that directory* User-directory information can only be saved by 
privleged users (WHEEL or OPERATOR) with their capabilities enabled* 



Word 

Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 





1 

••? 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 

16 

17 

20 

21 

22 

23 

24 

*~ w 

65 

105 

205 

405 

605 



Location Contents 

CHKSUM Checksum of record 

ACCESS (not used) 

TAPNO Relative Tape Number 

PAGN0 Page Number in File 

TYP Record Type Code (negated) C-53 

SEQ Record Sequence Number 

Length of argument block (20) 
Password Pointer (offset) 
Working disk Quota (octal) 
Capabi lities 
mode word 

Remanent disk Quota (octal) 
Directory number (octal) 
nyyFile protection default 
n.» ^directory protection 
Default Number of generations to keep 
Date of last login (universal) 
Address (offset) to user group list 
Address (offset) to directory group list 
Maximum number of Sub-directories 
Address (offset) of user group list 
Byte pointer to default account string 
Password 
Account string 
User group list- 
Directory Group list 
User group list 



fter 






cb££ far f>o(*4* 



fV 
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5*1*8 Continuation Header (record tupe 6) 



This record is the same in 
This header is written only when 
end of one reel onto another* 



format as the Saveset Header record. 
a saveset must be continued from the 



Word 



Location Contents 



Word CHKSUM Checksum of record 

Word 1 ACCESS (not used) 

Word 2 TAPNO Relative Tape Number 

Word 3 PAGNO Pas"e Number in File 

Word 4 TYP Record Type Code (negated) L-61 

Word 5 SEQ Record Seauence Number 

Word 6 BFMSG 3 

Word 7 BGNTAD Universal date and time 

Word 10 SSNBUF Saveset name* ASCIZ string- 
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5.2 Interchange Format Dumper Tapes 



Interchange tapes were originally supported to take information 
from a DECsastem-10 to a DECSYSTEM-20 * However? it is commonly used as 
3 means of transporting files? via t3Pe? to either system* Dumper 
attempts to copy the Interchange format as defined in Backup* There 
are some system dependencies such as the existence of end of file 
merks between savesets that cause glitches in the exchange of tapes. 

Dumper makes up a tape record as if it were writting an ordinary 
Dumper tape* and at the last minute? converts that record into the 
eauivalent Backup Interchange record. Dumper determines the maximum 
buffer length by taking the largest header it knows about (Interchange 
mode? 32(10)) and adds a page plus one to it ( 512(10) 1). So when 
Dumper goes off and creats Interchange records? it doesn't have to 
expand the buffer space in the program? it Just keeps shuffling things 
down to the end* 

Dumper does not fill 311 of the fields that Backup does in Inter- 
change formats* Items such as the physical device the tape was written 
on and the CPU number of the system used are missing* 

In the following record descriptions? all the words are named* 
The contents of those words are written by Dumper only if something is 
mentioned in the "Contents' 1 field of a line* 

The records are described in order as if there were "ordinary" 
Dumper records (ie* record type through 7). The description which 
follows is the end-result of Dumper's effort of converting the "ordi- 
nary* record into an Interchange record* 



Dumper always sets the GF$NCH (ignore checksum) bit of the GfFLAG 
word? and then (of course) proceeds to put the checksum from the -20 
into the 6$CHK word anyways* 



Dumper and Backup Tape Formats Page 2S 

Dumper Tape Formats 



5*2*1 Interchange D3ta Record (record type 0) 

This record starts out as a normal data record* This record is 
snslsSous to a TfFIL record as written by Backup* 



Word 




Name 


Contents 




Word 





<G*TYPE) 


Record Type 


Word 


1 


<G$SEQ> 


Record seauence Numbe 


Word 


2 


<G$RTN?i> 


Relative 


Tape Number 


Word 


3 


<G*FLAG> 


6F$E0F!GF*NCH 


Word 


4 


(G4CHK) 


Checksum 


( ignored ) 


Word 


5 


<G$SIZ) 


ICOLEN 




Word 


6 


(G$LND) 






Word 


13 


<G*CUSW) 


Customer 


Word 


Word 


14 


(F»PCHK) 






Word 


15 


<F*RDW) 


Relative 


Block Number 


Word 


16 


(F*PTH) 






Word 


37 


<F*CUSW> 


Customer 


Word 


Word 


40 




Dats 
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5*2*2 Interchange T3pe Header (record type 1) 

This Saveset header is stored in this record* This is analogous 
to a T$BEG record in Backup* 

Word Name Contents 

Word <G$TYPE) Record Type 

Word 1 (GfSEQ) Record sequence Number 

Word 2 (G$RTNM) Relative Tape Number 

Word 3 (G$FLAG> GF$NCH 

Word 4 (G$CHK) Checksum (ignored) 

Word 5 (G$SI2) 

Word 6 (G$LND> Word count of saveset name 

Word 13 (G$CUSW) Customer Word 

Word 14 <S*DATE) Universal D3te snd Time 

Word 15 (3*FMT) BKFMT (1) 

Word 16 <S*BVER) expected but not provided 

Word 17 (SfMON) expected but not provided 

Word 20 <S$SVER) expected but not provided 

Word 21 <S*APR) expected but not provided 

Word 22 <S$DEV) 

Word 23 (S$MTCH) 

Word 24 (S*RLNM) 

Word 25 (SfcLBLT) 

Word 37 <S*CUSW) 

Word 40 (0*SSNM) Sn-word count of saveset name 

Word 41 Saveset name* ASCIZ string 
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5.2.3 Interchange File Header (record tape 2) 

The file header record in Interchange mode contains only system 
independent data about the file. This record is analogous to a T$FIL 
record in Backup. 

Word Name Contents 

Word (Gf»TYPE) Record Type 

Word 1 (G*SEQ) Record sequence Number 

Word 2 (G$RTNH) Relative Tape Number 

Word 3 (G*FLAG) GFfNCH ! GFtSOF 

Word 4 (G$CHK) Checksum (ignored) 

Word 5 (G*SIZ) 

Word 6 (G*LND) FSNND (400) 

Word 13 (GfCUSW) Customer Word 

Word 14 (F$PCHK) 

Word 15 (F$RDW) 

Word 16 (F$PTH) 

Word 37 (F$CUSW) 

Word 40 (0$NAME) Is- ,200 

Word 240 (0*FILE) 2 f ?200 

Word 241 (AfFHLN) LN$AFH (32) 

Word 242 <A$FLGS) not used 

Word 243 (A$WRIT) .FBWRT of FDD 

Word 244 <A$ALLS) IC0LEN 

Word 245 (A$M0DE) .DMIMG 

Word 246 (A$LENG> .FBS.IZ of FDD 

Word 247 (A$BSIZ) 

Word 250 (A$VERS) 

The 0*NAME and 0$FILE blocks always BPf-esr in the same place in 
the same order. Dumper hardwires the lengths and the offsets of these 
blocks and lets monitor calls like S0UT terminate on the null at the 
end of the string. 
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5*2*4 Interchange File Trailer (record type 3) 

The standard Dumper File Trailer has no counterpart in Backup* 
The end of file in Interchange mode is determined by the GF$E0F flag 
in the G$FLAG word of a T*FIL record. 

5.2*5 Interchange Tape Trailer (record type 4) 

The tape trailer for Dumper Interchange contains the saveset 
name. This generates a T$END record* 

Word Name Contents 

Word (G$TYPE) Record Type 

Word 1 (G*SEQ> Record seauence Number 

Word 2 (G*RTNIi) Relative Tape Number 

Word 3 (G$FLAG> GF*NCH 

Word 4 (G*CHK) Checksum (ignored) 

Word 5 (G*SIZ) 

Word 6 (G$LND) Length of Saveset Name 

Word 13 (G$CUSW> Customer Word 

Word 14 (StDATE) Universal Date snd Time 

Word 15 (S$FMT) BKFMT (1) 

Word 16 (S*BVER) expected but not provided 

Word 17 (S$MGN) expected but not provided 

Word 20 (S*SVER> expected but not provided 

Word 21 (S*APR> expected but not provided 

Word 22 (S*DEV) 

Word 23 (S$HTCH> 

Word 24 (SfcRLNM) 

Word 25 (S*LBLT> 

Word 37 (SUCUSW) 

Word 40 <0$SSNM> 5 p? word count of saveset name 

Word 41 Saveset name? ASCII string 
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5.2*6 Interchange User Information (record type 5) 

This record is not written because it contains system dependent 
information ♦ 

5.2.7 Interchange Continuation Header (record type 6) 

This record is written on an Interchange tape. It is snslssous to 
a T$CON record in Backup. 

Word Name Contents 

Word (G*TYPE) Record Type 

Word 1 (G$SEQ> Record seetuence Number 

Word 2 (G*RTNM> Relative Tape Number 

Word 3 (G$FLAG> GFtNCH 

Word 4 (G$CHK) Checksum (ignored) 

Word 5 (GtSIZ) 

Word 6 <G$LND) Length of Saveset Name 

Word 13 (G$CUSW) Customer Word 

Word 14 <F$PCHK> 

Word 15 <F$RDW) Relative Block Number 

Word 16 <F*PTH) 

Word 37 (F*CUSW> Customer Word 

Word 40 (0*3SNM) 5?>words in saveset name 

Word 41 Saveset name* ASCII string 

5.2.8 Interchange Filler (record type 7) 

This record type has no counterpart in Interchange mode. 



